Rive 运行时入门

Rive 运行时是一组开源库，帮助你在应用、游戏与网站中加载并控制 Rive 动画。请进入各子页面开始使用！

如何使用本指南

本章节包含各平台的运行时子页面，提供在所选平台上开始使用所需的所有信息和资源。请参见下方的安装与接入。

此外，还有专门用于在运行时控制 Rive 图形的页面。例如，更新数据绑定属性以及带外加载资源。请参见下方的图形控制与交互。

安装与接入

请务必查看各运行时章节下的补充文档。这些文档提供了各平台的注意事项、迁移指南和高级用法信息。

Web 与移动端：

游戏引擎：

Unity
Unreal

图形控制与交互

以下文档介绍如何在运行时与 Rive 图形交互。请选择你的运行时查看相应指南：

功能	Web	React	React Native	Flutter	Apple	Android
动画播放	→	→	→	→	→	→
画板	→	→	→	→	→	→
数据绑定	→	→	→	→	→	→
状态机	→	→	→	→	→	→
布局	→	→	→	→	→	→
文本	→	→	→	→	→	→
字体	→	→	→	→	→	→
播放音频	→	→	→	→	→	→
Rive 事件	→	→	→	→	→	→
加载资源	→	→	→	→	→	→
缓存 Rive 文件	→	→	→	→	→	→

注意：部分旧版 API（如通过输入（Inputs）直接控制动画、手动文本操作）已被标记为已弃用，推荐统一使用数据绑定（Data Binding）替代。

其他章节

版本说明

随着编辑器能力演进，运行时也会持续更新以支持新特性。你可以在 Feature Support 查看某项能力所需的最低运行时版本。

通常情况下，最新运行时仍兼容较早导出的 .riv 文件，不一定需要重导出。

若确实需要重导出，可参考：

运行时导出说明

官方运行时仓库

平台	分发方式	仓库
Web	npm (`@rive-app/canvas`, `@rive-app/webgl2`, `@rive-app/canvas-lite`)	rive-wasm
React	npm (`@rive-app/react-canvas`, `@rive-app/react-webgl2`, `@rive-app/react-canvas-lite`)	rive-react
React Native	npm (`rive-react-native`)	rive-react-native
Apple	Swift Package Manager / Cocoapods	rive-ios
Android	Maven (`app.rive:rive-android`)	rive-android
Flutter	pub.dev (`rive`)	rive-flutter
C++	源码	rive-cpp

社区运行时

运行时	作者	链接
QtQuick	basysKom	GitHub
UWP (C#)	Windows Community Toolkit	GitHub
Angular	社区	→ 详细文档
RiveCMP	muazkadan	GitHub

`.riv` 文件处理建议

将 .riv 文件提交到 Git 时，建议在 .gitattributes 中声明为二进制，避免行尾转换导致文件损坏：

# .gitattributes
*.riv binary

许可协议

官方运行时均采用 MIT License 开源，可用于个人与商业项目。

参与贡献

所有官方运行时仓库均开源。欢迎你提交 Issue、PR，或 fork 后参与改进。

如何使用本指南​

安装与接入​

图形控制与交互​

其他章节​

版本说明​

官方运行时仓库​

社区运行时​

.riv 文件处理建议​

许可协议​

参与贡献​